<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<!--[if lt IE 9]>
  <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
<![endif]-->
<title>VIM 中文用户手册: 创建新的命令</title>
<link rel="stylesheet" href="vim-stylesheet.css" type="text/css" />
<link rel="canonical" href="https://yianwillis.github.io/vimcdoc/doc/usr_40.html" />
<script type="text/javascript" src="vimcdoc.js"></script>
<meta name="viewport" content="width=device-width, initial-scale=1" />
</head>
<body>
<nav id=banner>
<form action=tags.html target="tag_iframe">
  <input type="text" name="tag" id="tag" placeholder="标签搜索">
</form>
<iframe name="tag_iframe" src=""></iframe>
<a href="help.html">帮助总览</a> &middot;
<hr/>
<a href="quickref.html">快速参考</a> &middot;
<a href="index.html">命令索引</a> &middot;
<a href="eval.html#functions">函数列表</a> &middot;
<a href="quickref.html#option-list">选项列表</a> &middot;
<hr/>
<a href="usr_toc.html">用户手册</a> &middot;
<a href="help.html#reference_toc">参考手册</a> &middot;
</nav>

<header>
<h2>usr_40</h2>
</header>
<article id=outer>
<section class=inner>
<b class="vimtag"> <a name="usr_40.txt">usr_40.txt</a> </b>    适用于 Vim 9.0 版本。   最近更新: 2022年8月

                     <code class="vim">VIM 用户手册 - by Bram Moolenaar</code>
                                <code class="vim">译者</code>: lang2

                              创建新的命令


Vim 是一个可扩展的编辑器。你可以把一系列你常用的命令组合成一个新的命令。或者重
新定义一个现存的命令。各种命令的自动执行可以通过自动命令实现。

 <a href="usr_40.html#40.1">40.1</a>   键映射
 <a href="usr_40.html#40.2">40.2</a>   定义命令行命令
 <a href="usr_40.html#40.3">40.3</a>   自动命令

        下一章:  <a href="usr_41.html#usr_41.txt">usr_41.txt</a>   编写 Vim 脚本
        前一章:  <a href="usr_32.html#usr_32.txt">usr_32.txt</a>   撤销树
          目录:  <a href="usr_toc.html#usr_toc.txt">usr_toc.txt</a> 

</section><hr class="doubleline" /><section class=inner>
<h4><b class="vimtag"> <a name="40.1">40.1</a> </b>  键映射</h4>
简单的映射已经在  <a href="usr_05.html#05.4">05.4</a>  介绍过了。基本的概念是将一系列的键输入转换成为另外一个
键输入序列。这是一个很简单，但是很有效的机制。
   最简单的形式是将一个键输入序列映射到一个键上。由于那些除了 <code class="special">&lt;F1&gt;</code> 外的功能键
都没有预先定义的功能，选择它们作为映射对象是很有效的。例如: 
<code class="example"></code>
<code class="example">        :map &lt;F2&gt; GoDate: &lt;Esc&gt;:read !date&lt;CR&gt;kJ</code>
<code class="example"></code>
这显示了如何使用三种不同的运行模式。在用 "G" 移动到最后一行后，"o" 命令开始一
个新行并开始插入模式。然后文本 "Date: " 被输入并用 <code class="special">&lt;Esc&gt;</code> 离开插入模式。
   <code class="note">注意</code>在 <code class="special">&lt;&gt;</code> 内使用的特殊键。这叫尖括号记法。你要分别地输入这些字符，而不是键
入要表示的键本身。这使得映射更具可读性，而且你也可以方便地拷贝，粘贴文本。
   ":" 使得 Vim 回到命令行。":read !date" 命令读取 "date" 命令的输出并添加到当
前行之下。<code class="special">&lt;CR&gt;</code> 是用来执行该命令的。
   到此为止，文本看起来像:

<code class="section">        Date:  </code>
<code class="section">        Fri Jun 15 12:54:34 CEST 2001 </code>

然后 "kJ" 将光标上移并将两行连接起来。
   参阅  <a href="map.html#map-which-keys">map-which-keys</a>  可以帮助你决定应该使用哪些键来作映射。


映 射 与 运 行 模 式

":map" 命令定义普通模式的键映射。你也可以为其它运行模式定义映射。例如，":imap"
用来定义插入模式的映射。你可以用它来定义一个插入日期的映射: 
<code class="example"></code>
<code class="example">        :imap &lt;F2&gt; &lt;CR&gt;Date: &lt;Esc&gt;:read !date&lt;CR&gt;kJ</code>
<code class="example"></code>
看起来很像前面为普通模式定义的 <code class="special">&lt;F2&gt;</code> 映射。只是开始的地方有所不同。普通模式下的
<code class="special">&lt;F2&gt;</code> 映射依然有效。这样你就可以在各种模式下为同一映射键定义不同的映射。
   应该<code class="note">注意</code>的是，虽然这个映射以插入模式开始，但它却以普通模式结束。如果你希望
继续插入模式，可以在最后加上 "a"。

下面是一个映射命令及其生效模式的总览:

        :map            普通，可视模式及操作符等待模式
        :vmap           可视模式
        :nmap           普通模式
        :omap           操作符等待模式
        :map!           插入和命令行模式
        :imap           插入模式
        :cmap           命令行模式

操作符等待模式是当你键入一个操作符 (比如 "d" 或 "y") 之后，Vim 期待你键入一个
动作命令或者文本对象时的状态。比如，当你键入命令 "dw"， 那个 "w" 就是在操作符
等待模式下键入的。

假定你想定义映射 <code class="special">&lt;F7&gt;</code> 使得命令 d<code class="special">&lt;F7&gt;</code> 删除一个 C 程序块 (<code class="special">{}</code> 包括的文本)。类似的
y<code class="special">&lt;F7&gt;</code> 会将程序块拷贝到匿名的寄存器。因此，你所要做的就是定义 <code class="special">&lt;F7&gt;</code> 来选择当前的
语法块。你可以用下面的命令做到: 
<code class="example"></code>
<code class="example">        :omap &lt;F7&gt; a{</code>
<code class="example"></code>
这使得 <code class="special">&lt;F7&gt;</code> 在操作符等待模式下选择一个块，就像是你键入了 "a{" 一样。这个映射在
你不容易键入 { 时比较有用。


映 射 列 表

要查看当前定义的映射，使用不带参数的 ":map" 命令。或者其它运行模式的变体。输出
应该类似于:

<code class="section">           _g            :call MyGrep(1)<code class="special">&lt;CR&gt;</code> </code>
<code class="section">        v  <code class="special">&lt;F2&gt;</code>          :s/^/&gt; /<code class="special">&lt;CR&gt;</code>:noh<code class="special">&lt;CR&gt;</code>`` </code>
<code class="section">        n  <code class="special">&lt;F2&gt;</code>          :.,$s/^/&gt; /<code class="special">&lt;CR&gt;</code>:noh<code class="special">&lt;CR&gt;</code>`` </code>
           <code class="special">&lt;xHome&gt;</code>       <code class="special">&lt;Home&gt;</code>
           <code class="special">&lt;xEnd&gt;</code>        <code class="special">&lt;End&gt;</code>


第一列显示该映射有效的运行模式。"n" 表示普通模式，"i" 表示插入模式，等等。空白
表示用 ":map" 命令定义的映射，也就是对普通和可视模式有效。
   列出映射的一个比较实用的目的是检查 <code class="special">&lt;&gt;</code> 表示的特殊键是否被识别了 (仅当支持多
色彩是有效)。例如，当 <code class="special">&lt;Esc&gt;</code> 被用彩色显示时，它表示转义字符。否则，只是 5 个不
同的字符。


重 映 射

映射的结果会检查其中包括的其他映射。例如，上面对 <code class="special">&lt;F2&gt;</code> 的映射可以减短为: 
<code class="example"></code>
<code class="example">        :map &lt;F2&gt; G&lt;F3&gt;</code>
<code class="example">        :imap &lt;F2&gt; &lt;Esc&gt;&lt;F3&gt;</code>
<code class="example">        :map &lt;F3&gt;  oDate: &lt;Esc&gt;:read !date&lt;CR&gt;kJ</code>
<code class="example"></code>
在普通模式下 <code class="special">&lt;F2&gt;</code> 被映射为: 行进至最后一行，然后输入 <code class="special">&lt;F3&gt;</code>；在插入模式下先键入
<code class="special">&lt;Esc&gt;</code> 后也输入 <code class="special">&lt;F3&gt;</code>。接下来 <code class="special">&lt;F3&gt;</code> 也被映射，执行真正的工作。

假设你几乎不使用 Ex 模式，并想用 "Q" 命令来排版文本 (就像旧版本的 Vim 那样)。
下面的映射就能做到: 
<code class="example"></code>
<code class="example">        :map Q gq</code>
<code class="example"></code>
但是，你总有需要用到 Ex 模式的时候。我们来将 "gQ" 映射为 Q，这样你仍然可以进入
Ex 模式: 
<code class="example"></code>
<code class="example">        :map gQ Q</code>
<code class="example"></code>
这样一来当你键入 "gQ" 时它被映射为 "Q"。到现在为止一切顺利。但由于 "Q" 被映射
为 "gq"， 输入的 "gQ" 被解释成为 "gq"， 你根本就没进入 Ex 模式。
   要避免键被再次映射，使用 ":noremap" 命令: 
<code class="example"></code>
<code class="example">        :noremap gQ Q</code>
<code class="example"></code>
现在 Vim 就知道了对 "Q" 不需要检查与之相关的映射。对于每个模式都有一个类似的命
令:

        :noremap        普通，可视和操作符等待模式
        :vnoremap       可视模式
        :nnoremap       普通模式
        :onoremap       操作符等待模式
        :noremap!       插入和命令行模式
        :inoremap       插入模式
        :cnoremap       命令行模式


递 归 映 射

当一个映射调用它本身的时候，会无限制的运行下去。这可以被用来无限次重复一个操
作。
   例如，你有一组文件，每个的第一行都包括一个版本号。你用 "vim *.txt" 来编辑它
们。你现在正在编辑第一个文件。定义下面的映射: 
<code class="example"></code>
<code class="example">        :map ,, :s/5.1/5.2/&lt;CR&gt;:wnext&lt;CR&gt;,,</code>
<code class="example"></code>
现在当你键入 ",," 时，上面的映射被触发。它把第一行的 "5.1" 替换为 "5.2"。接着
执行 ":wnext" 来写入文件并开始编辑下一个。映射以 ",," 结束。这又触发了同一个映
射，再次执行替换操作，依此类推。
   这个映射会一直进行下去，直至遇到错误为止。在这里可能是查找命令无法匹配到
"5.1" 。你可以自行插入 "5.1" 然后再次键入 ",,"。或者 ":wnext" 因为遇到最后一个
文件而失败。
   当映射在中途遇到错误时，映射的剩余部分会被放弃。你可用 <code class="keystroke">CTRL-C</code> 中断映射。(在
MS-Windows 上用 <code class="keystroke">CTRL-Break</code>)。


删 除 映 射

要删除一个映射，使用 ":unmap" 命令。同样，删除映射的命令也和运行模式相关:

        :unmap          普通，可视和操作符等待模式
        :vunmap         可视模式
        :nunmap         普通模式
        :ounmap         操作符等待模式
        :unmap!         插入和命令行模式
        :iunmap         插入模式
        :cunmap         命令行模式

这里有个小技巧可以定义一个对普通模式和操作符等待模式有效而对可视模式无效的映
射: 先对三个模式都定义映射，然后将可视模式的那个删除: 
<code class="example"></code>
<code class="example">        :map &lt;C-A&gt; /---&gt;&lt;CR&gt;</code>
<code class="example">        :vunmap &lt;C-A&gt;</code>
<code class="example"></code>
<code class="note">注意</code>那 5 个字符 "<code class="special">&lt;C-A&gt;</code>" 表示一个键组合 <code class="keystroke">CTRL-A</code>。

要清除所有的映射，使用  <a href="map.html#:mapclear">:mapclear</a>  命令。现在你应该可以猜到各种模式下的变体了
吧。要当心使用这个命令，它不可能被撤销。


特 殊 字 符

在 ":map" 命令后面可以追加另一个命令。需要用 | 字符来将两个命令分开。这也就意
味着一个映射中不能直接使用该字符。需要时，可以用 <code class="special">&lt;Bar&gt;</code> (五个字符)。例如:

<code class="example">        :map &lt;F8&gt; :write &lt;Bar&gt; !checkin %:S&lt;CR&gt;</code>
<code class="example"></code>
":unmap" 命令有同样的问题，而且你得留意后缀的空白字符。下面两个命令是不同的:

<code class="example">        :unmap a | unmap b</code>
<code class="example">        :unmap a| unmap b</code>
<code class="example"></code>
第一个命令试图删除映射 "a "，后面带有一个空格。

当要在一个映射内使用空格时，应该用 <code class="special">&lt;Space&gt;</code> (七个字符): 
<code class="example"></code>
<code class="example">        :map &lt;Space&gt; W</code>
<code class="example"></code>
这使得空格键移动到下一个空白字符分割的单词。

在一个映射后不能直接加注释，因为 " 字符也被当作是映射的一部分。你可以用 |" 绕
过这一限制。这实际上是开始一个新的空命令。例如: 
<code class="example"></code>
<code class="example">        :map &lt;Space&gt; W|     " Use spacebar to move forward a word</code>
<code class="example"></code>
<code class="example"></code>
映 射 与 缩 写

缩写和插入模式的映射很像。对参数的处理它们是一样的。它们主要的不同在于触发的方
式。缩写是由单词之后的非单词字符触发的。而映射由其最后一个字符触发。
   另一个区别是你键入的缩写的字符会在你键入的同时被插入到文本内。当缩写被触发
时，这些字符会被删除并替换成缩写所对应的字符。当你键入一个映射时，直到你完成所
有的映射键而映射被触发时，映射所对应的内容才会被插入。如果你置位 <a href="options.html#'showcmd'">'showcmd'</a> 选
项，键入的字符会显示在 Vim 窗口的最后一行。
   有一个例外是当映射有歧义的时候。假定你有两个映射: 
<code class="example"></code>
<code class="example">        :imap aa foo</code>
<code class="example">        :imap aaa bar</code>
<code class="example"></code>
现在，当你键入 "aa" 时，Vim 不知道是否要使用第一个映射。它会等待另一个键输入。
如果是 "a"，第二个映射被执行，结果是 "bar"。如果是其它字符，例如空格，第一个映
射被执行，结果是 "foo"， 而且空格字符也会被插入。


另 外 ...

<code class="special">&lt;script&gt;</code> 关键字可以被用来使一个映射仅对当前脚本有效。参见  <a href="map.html#:map-%3Cscript%3E">:map-&lt;script&gt;</a> 。

<code class="special">&lt;buffer&gt;</code> 关键字可以被用来使一个映射仅对当前缓冲区有效。参见  <a href="map.html#:map-%3Cbuffer%3E">:map-&lt;buffer&gt;</a> 。

<code class="special">&lt;unique&gt;</code> 关键字可以被用来当一个映射已经存在时不允许重新定义。否则的话新的映射
会简单的覆盖旧的。参见  <a href="map.html#:map-%3Cunique%3E">:map-&lt;unique&gt;</a> 。

如果要使一个键无效，将之映射至 <code class="special">&lt;Nop&gt;</code> (五个字符)。下面的映射会使 <code class="special">&lt;F7&gt;</code> 什么也干
不了: 
<code class="example"></code>
<code class="example">        :map &lt;F7&gt; &lt;Nop&gt;| map! &lt;F7&gt; &lt;Nop&gt;</code>
<code class="example"></code>
<code class="note">注意</code> <code class="special">&lt;Nop&gt;</code> 之后一定不能有空格。

</section><hr class="doubleline" /><section class=inner>
<h4><b class="vimtag"> <a name="40.2">40.2</a> </b>  定义命令行命令</h4>
Vim 编辑器允许你定义你自己的命令。你可以像运行其他命令行命令一样运行你自定义的
命令。
   要定义一个命令，像下面一样执行 ":command" 命令: 
<code class="example"></code>
<code class="example">        :command DeleteFirst 1delete</code>
<code class="example"></code>
现在当你执行 ":DeleteFirst" 命令时，Vim 执行 ":1delete" 来删除第一行。

        <code class="note">备注</code>:
        用户定义的命令必须以大写字母开始，但不能用 ":X"，":Next" 和 ":Print"。
        也不能用下划线！你可以使用数字，但是不鼓励这么做。

要列出用户定义的命令，执行下面的命令: 
<code class="example"></code>
<code class="example">        :command</code>
<code class="example"></code>
像那些内建的命令一样，用户自定义的命令也可以被缩写。你只需要键入足够区别于其它
命令的字符就可以了。命令行补全也有效。


参 数 个 数

自定义命令可以带一系列的参数。参数的数目必须用 -nargs 选项来指定。例如，上面
例子中的 :DeleteFirst 命令不带参数，所以你也可以这样来定义: 
<code class="example"></code>
<code class="example">        :command -nargs=0 DeleteFirst 1delete</code>
<code class="example"></code>
不过，因为缺省参数数目为 0，你没有必要加上 "-nargs=0"。其它可用的值是:

        -nargs=0        无参数
        -nargs=1        一个参数
        -nargs=*        任意数目的参数
        -nargs=?        没有或一个参数
        -nargs=+        一个或更多参数


使 用 参 数

在命令的定义中，<code class="special">&lt;args&gt;</code> 关键字可以用来表示命令带的参数。例如: 
<code class="example"></code>
<code class="example">        :command -nargs=+ Say :echo "&lt;args&gt;"</code>
<code class="example"></code>
现在当你输入 
<code class="example"></code>
<code class="example">        :Say Hello World</code>
<code class="example"></code>
Vim 会显示 "Hello World"。然而如果你加上一个双引号，就不行了。例如: 
<code class="example"></code>
<code class="example">        :Say he said "hello"</code>
<code class="example"></code>
要把特殊字符放到字符串里，必须在它们的前面加上反斜杠，用 "<code class="special">&lt;q-args&gt;</code>" 就可以: 
<code class="example"></code>
<code class="example">        :command -nargs=+ Say :echo &lt;q-args&gt;</code>
<code class="example"></code>
现在上面的 ":Say" 命令会引发下面的命令被执行: 
<code class="example"></code>
<code class="example">        :echo "he said \"hello\""</code>
<code class="example"></code>
关键字 <code class="special">&lt;f-args&gt;</code> 包括与 <code class="special">&lt;args&gt;</code> 一样的信息，不过它将其转换成适用于函数调用的格
式。例如:

<code class="example">        :command -nargs=* DoIt :call AFunction(&lt;f-args&gt;)</code>
<code class="example">        :DoIt a b c</code>
<code class="example"></code>
会执行下面的命令: 
<code class="example"></code>
<code class="example">        :call AFunction("a", "b", "c")</code>
<code class="example"></code>
<code class="example"></code>
行 范 围

有些命令需要一个范围作为参数。要告诉 Vim 你需要定义这样的命令，使用 -range 选
项。它可能的值如下:

        -range          允许范围；缺省为当前行。
        -range=%        允许范围；缺省为整个文件。
        -range=<code class="special">{count}</code>  允许范围；只用该范围最后的行号作为单个数字的参数，其缺
                        省值为 <code class="special">{count}</code>。

当一个范围被指定时，关键字 <code class="special">&lt;line1&gt;</code> 和 <code class="special">&lt;line2&gt;</code> 可以用来取得范围的首行和末行的行
号。例如，下面的命令定义将指定的范围写入文件 "save_file" 的命令 - SaveIt: 
<code class="example"></code>
<code class="example">        :command -range=% SaveIt :&lt;line1&gt;,&lt;line2&gt;write! save_file</code>
<code class="example"></code>
<code class="example"></code>
其 它 选 项

其它的一些选项有:

        -count=<code class="special">{number}</code>         命令可以带 count 参数，缺省为 <code class="special">{number}</code>。
                                用 <code class="special">&lt;count&gt;</code> 关键字可以访问该参数。
        -bang                   允许使用 !。若 ! 出现，<code class="special">&lt;bang&gt;</code> 扩展为 !。
        -register               你可以指定一个寄存器。(缺省为无名寄存器。)
                                指定的寄存器可通过 <code class="special">&lt;reg&gt;</code> (即 <code class="special">&lt;register&gt;</code>) 来操
                                作。
        -complete=<code class="special">{type}</code>        给出命令行补全的方式。 <a href="map.html#:command-completion">:command-completion</a> 
                                列出了所有可用值。
        -bar                    命令后可用 | 加另外一个命令，或 " 加一个注释。
        -buffer                 命令仅对当前缓冲区有效。

最后，你还可以使用 <code class="special">&lt;lt&gt;</code> 关键字来代表字符 &lt;。这样可以转义上面提到的 <code class="special">&lt;&gt;</code> 项目的特
殊含义。


重 定 义 和 删 除

! 参数可以用来重新定义相同的命令: 
<code class="example"></code>
<code class="example">        :command -nargs=+ Say :echo "&lt;args&gt;"</code>
<code class="example">        :command! -nargs=+ Say :echo &lt;q-args&gt;</code>
<code class="example"></code>
要删除自定义命令，使用 ":delcommand"。该命令只带一个参数，那就是自定义命令的
名字。例: 
<code class="example"></code>
<code class="example">        :delcommand SaveIt</code>
<code class="example"></code>
要一次删除所有的自定义命令: 
<code class="example"></code>
<code class="example">        :comclear</code>
<code class="example"></code>
要当心！这个命令无法撤销。

关于所有这些内容的更多信息可参阅参考手册:  <a href="map.html#user-commands">user-commands</a> 。

</section><hr class="doubleline" /><section class=inner>
<h4><b class="vimtag"> <a name="40.3">40.3</a> </b>  自动命令</h4>
自动命令是一类特殊的命令。当某些事件，例如文件读入或改变缓冲区等事件发生时，它
们会自动被执行。例如，通过自动命令你可以教 Vim 来编辑压缩文件。这个功能被用在
 <a href="pi_gzip.html#gzip">gzip</a>  插件里。
   自动命令非常强大。如果你小心使用的话，自动命令可以省去你很多自己敲命令的麻
烦。如果不当心的话你就是自找麻烦。

假设你希望在每次写入文件时自动的替换文件尾部的日期戳。先定义一个函数: 
<code class="example"></code>
<code class="example">        :function DateInsert()</code>
<code class="example">        :  $delete</code>
<code class="example">        :  read !date</code>
<code class="example">        :endfunction</code>
<code class="example"></code>
你需要在每次缓冲区写入文件之前想办法调用该函数。下面这一行就能做到: 
<code class="example"></code>
<code class="example">        :autocmd BufWritePre *  call DateInsert()</code>
<code class="example"></code>
"BufWritePre" 是这个自动命令的触发事件: 把缓冲区写入文件前 (pre)。"*" 是一个用
来匹配文件名的模式。这儿它匹配所有文件。
   如果这个命令生效，当你调用 ":write" 时，Vim 检查是否有匹配 BufWritePre 事件
的自动命令并执行它们。然后才执行 ":write"。
   通用的 :autocmd 命令格式如下: 
<code class="example"></code>
<code class="example">        :autocmd [group] {events} {file-pattern} [++nested] {command}</code>
<code class="example"></code>
组名 <code class="special">[group]</code> 是可选的。它被用来管理和调用命令 (后面再讲)。<code class="special">{events}</code> 参数是一个
触发事件列表 (用逗号隔开)。
   <code class="special">{file-pattern}</code> 是文件命令，通常带有通配符。例如，用 "*.txt" 会使得自动命令
对所有文件名以 ".txt" 结尾的文件被调用。可选项 [++nested] 允许自动命令的嵌套
(见下)。最后，<code class="special">{command}</code> 是要被执行的命令。

增加自动命令时，原有的自动命令依然保留。要避免多次加入自动命令可用以下形式: 
<code class="example"></code>
<code class="example">        :augroup updateDate</code>
<code class="example">        :  autocmd!</code>
<code class="example">        :  autocmd BufWritePre *  call DateInsert()</code>
<code class="example">        :augroup END</code>
<code class="example"></code>
定义新的自动命令之前， <code class="badlink">:autocmd!</code>  先删除之前定义的自动命令。关于组以后细讲。


事 件

最有用的事件之一是 BufReadPost。它在一个文件被调入编辑之后被触发。常被用来设定
相关的选项。例如，你已知 ".gsm" 文件是 GNU 汇编程序源码。为确保使用正确的语法
文件，可以定义这样的自动命令: 
<code class="example"></code>
<code class="example">        :autocmd BufReadPost *.gsm  set filetype=asm</code>
<code class="example"></code>
如果 Vim 能够正确的识别文件类型的话，它将为你设定 <a href="options.html#'filetype'">'filetype'</a> 选项。这会触发
Filetype 事件。你可以利用这个来为某一类型的文件做编辑的准备工作。例如，要为文
本文件调入一组缩写: 
<code class="example"></code>
<code class="example">        :autocmd Filetype text  source ~/.vim/abbrevs.vim</code>
<code class="example"></code>
在开始编辑一个新文件时，你可以要求 Vim 插入一个模板: 
<code class="example"></code>
<code class="example">        :autocmd BufNewFile *.[ch]  0read ~/skeletons/skel.c</code>
<code class="example"></code>
在  <a href="autocmd.html#autocmd-events">autocmd-events</a>  可以找到一个完整的事件列表。


匹 配 模 式

那个 <code class="special">{file-pattern}</code> 参数实际上可以是一个以逗号分割开的模式列表。例如:
"*.c,*.h" 匹配所有文件名以 ".c" 和 ".h" 结尾的文件。
   常见的文件通配符都可以使用。这里给出一个最常用的清单:

        *               匹配任意字符，任意多次
        ?               匹配任意字符，一次
        <code class="special">[abc]</code>           匹配 a、b 或 c
        .               匹配一个点 .
        a<code class="special">{b,c}</code>          匹配 "ab" 和 "ac"

当模式包括斜杠 (/) 时 Vim 会比较路径名。否则只有文件名的最后部分才用来作比较。
例如，"*.txt" 匹配 "/home/biep/readme.txt"。模式 "/home/biep/*" 也可以匹配那个
文件。但是 "home/foo/*.txt" 就不行。
   当包括斜杠时，Vim 会试着匹配文件的完整路径 ("/home/biep/readme.txt") 和相对
路径 (例如:  "biep/readme.txt")。

        <code class="note">备注</code>:
        当在使用反斜杠作为文件分隔符的系统 (如 MS-Windows) 上工作时，你也得在
        自动命令中使用正斜杠。这会使编写匹配模式变得容易些，因为反斜杠有特殊的
        意义。它同时也使自动命令更具可移植性。


删 除

要删除一个自动命令，使用和定义它一样的命令格式。但不要包括后面的 <code class="special">{command}</code>
部分，而且要加上 !。例如: 
<code class="example"></code>
<code class="example">        :autocmd! FileWritePre *</code>
<code class="example"></code>
这样会删除为 "FileWritePre" 事件定义的匹配 "*" 文件名模式的所有自动命令。


列 表

要列出当前定义的所有自动命令，用这个: 
<code class="example"></code>
<code class="example">        :autocmd</code>
<code class="example"></code>
这个列表可能会相当长，特别是在使用了文件类型检测时。你可以指定组，事件和/或文
件名模式来要求仅列出相关的命令。例如，要列出 BufNewFile 事件的所有自动命令: 
<code class="example"></code>
<code class="example">        :autocmd BufNewFile</code>
<code class="example"></code>
列出所有匹配文件名模式 "*.c" 的命令: 
<code class="example"></code>
<code class="example">        :autocmd * *.c</code>
<code class="example"></code>
使用 "*" 作为事件会给出所有事件的列表。要列出 cprograms 组对应的自动命令: 
<code class="example"></code>
<code class="example">        :autocmd cprograms</code>
<code class="example"></code>
<code class="example"></code>
组

当定义自动命令时用到 <code class="special">{group}</code> 这一项时，自动命令会被分成组。比如说，这可以被用
来删除一个组中的所有命令。
   在为某一个组定义数个自动命令时，可以使用 ":augroup" 命令。例如，我们来定义
一些用于 C 程序的自动命令: 
<code class="example"></code>
<code class="example">        :augroup cprograms</code>
<code class="example">        :  autocmd BufReadPost *.c,*.h :set sw=4 sts=4</code>
<code class="example">        :  autocmd BufReadPost *.cpp   :set sw=3 sts=3</code>
<code class="example">        :augroup END</code>
<code class="example"></code>
这和下面的命令有一样的效果: 
<code class="example"></code>
<code class="example">        :autocmd cprograms BufReadPost *.c,*.h :set sw=4 sts=4</code>
<code class="example">        :autocmd cprograms BufReadPost *.cpp   :set sw=3 sts=3</code>
<code class="example"></code>
要删除 "cprograms" 组中的所有自动命令: 
<code class="example"></code>
<code class="example">        :autocmd! cprograms</code>
<code class="example"></code>
<code class="example"></code>
嵌 套

一般的，某一事件触发的自动命令在被执行时不会再触发其它事件。例如，当因
FileChangedShell 事件而读入一个文件时，那些被定义来设定语法的自动命令就不会被
触发。要使那些命令被触发，加上一个 "nested" 参数: 
<code class="example"></code>
<code class="example">        :autocmd FileChangedShell * ++nested  edit</code>
<code class="example"></code>
<code class="example"></code>
执 行 自 动 命 令

Vim 允许你用模拟某一事件发生的办法来触发一个自动命令。这可以在一个自动命令里用
来触发另外一个。例如: 
<code class="example"></code>
<code class="example">        :autocmd BufReadPost *.new  execute "doautocmd BufReadPost " . expand("&lt;afile&gt;:r")</code>
<code class="example"></code>
这定义了一个新文件开始编辑之后触发的自动命令。这个文件的文件名必须以 ".new" 结
尾。其中的 ":execute" 命令利用表达式求值来组成一个新的命令并执行之。当编辑文件
"tryout.c.new" 时被执行的命令将是: 
<code class="example"></code>
<code class="example">        :doautocmd BufReadPost tryout.c</code>
<code class="example"></code>
expand() 函数的参数是 "<code class="special">&lt;afile&gt;</code>"，用来代表自动命令执行所关联的文件。":r" 指定仅
使用其根部分。

":doautocmd" 执行于当前缓冲区。":doautoall" 命令于 "doautocmd" 命令类似但执行
于所有缓冲区。


使 用 普 通 模 式 命 令

自动命令所执行的命令是 "命令行" 命令。如果你想在其中执行普通模式命令，可以使用
":normal" 命令。例如: 
<code class="example"></code>
<code class="example">        :autocmd BufReadPost *.log normal G</code>
<code class="example"></code>
这样，当你编辑 *.log 文件时 Vim 会将光标移动到最后一行。
   使用 ":normal" 命令需要点技巧。首先，你要确保其参数是一个包括所有参数的完整
命令。当你用 "i" 进入插入模式时，你必须用 <code class="special">&lt;Esc&gt;</code> 离开。如果你用 "/" 来开始查
找，你也必须用 <code class="special">&lt;CR&gt;</code> 执行该查找命令。
   ":normal" 命令会使用其后的所有文本作为将要执行的命令。因此不可能用 | 来后跟
另一个命令。有个办法可以绕过这个约束: 把 ":normal" 命令放在 ":execute" 命令之
内。这个方法同时也方便了不可显示的字符作为参数的传递。例如: 
<code class="example"></code>
<code class="example">        :autocmd BufReadPost *.chg execute "normal ONew entry:\&lt;Esc&gt;" |</code>
<code class="example">                \ 1read !date</code>
<code class="example"></code>
上面的例子还展示了如何用反斜杠来将一个长命令分为几行。这可以用在 Vim 脚本中
(不能用在命令行)。

如果你想让你的自动命令作一些复杂的操作，其中涉及在文件间跳转然后回到原来位置，
你希望能够恢复文件的视窗位置。 <a href="tips.html#restore-position">restore-position</a>  有些例子。


忽 略 事 件

有些时候，你并不想触发自动命令。<a href="options.html#'eventignore'">'eventignore'</a> 选项包括了一组会被 Vim 完全忽略
的事件。例如，下面的命令会使得进入和离开窗口的事件被忽略掉: 
<code class="example"></code>
<code class="example">        :set eventignore=WinEnter,WinLeave</code>
<code class="example"></code>
要忽略所有的事件，用下面的命令: 
<code class="example"></code>
<code class="example">        :set eventignore=all</code>
<code class="example"></code>
要恢复到正常的状态，把 <a href="options.html#'eventignore'">'eventignore'</a> 设定为空即可: 
<code class="example"></code>
<code class="example">        :set eventignore=</code>
<code class="example"></code>
</section><hr class="doubleline" /><section class=inner>
<h4></h4>下一章:  <a href="usr_41.html#usr_41.txt">usr_41.txt</a>   编写 Vim 脚本

版权: 参见  <a href="usr_01.html#manual-copyright">manual-copyright</a>   vim:tw=78:ts=8:noet:ft=help:norl:
</section>
</article>
<footer>
Generated by vim2html
</footer>
</body>
</html>
